4.1 新增本地用户角色

基本信息

Path: /api/v2/localUserRole/create

Method: POST

接口描述: 1、需要关联"适用对象"->"组织架构"时,使用 groupNameList 可能导致关联到多个同名组织架构,后续将不再维护此参数,建议使用 groupFullPathList 作为替代

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/json 必须  

Body

名称 类型 是否必须 默认值 备注 其他信息
name string 必须 角色名
description string 非必须 描述
userIdList string[] 非必须 适用对象-用户ID列表 通过用户查询接口可以获取ID,与 userNameList只传一个即可,都传时以userIdList为主
userNameList string[] 非必须 适用对象-用户名列表 >=2.2.16开始支持, 与 userIdList只传一个即可,都传时以userIdList为主
resourceIdList string[] 非必须 应用ID列表 通过应用查询接口可以获取ID
resourceNameList string[] 非必须 应用名列表 >=2.2.16开始支持, resourceIdList和resourceNameList只传一个即可,都传时以resourceIdList为准
resourceGroupIdList string[] 非必须 应用分类ID列表 通过应用分类查询接口可以获取ID
resourceGroupNameList string[] 非必须 应用分类名列表 >=2.2.16开始支持, resourceGroupIdList和resourceGroupNameList只传一个即可,同时传时以resourceGroupIdList为准
groupIdList string[] 非必须 适用对象-组织架构ID列表 与groupNameList、groupFullPathList只传一个即可,传多个参数时优先级为:groupIdList > groupFullPathList > groupNameList
groupFullPathList string[] 非必须 适用对象-组织架构全路径列表,如:["/a/b", "/a/c"] 与groupIdList、groupNameList只传一个即可
groupNameList string[] 非必须 (该字段不再维护)适用对象-组织架构名列表,如:["b", "c"] 与groupIdList、groupFullPathList只传一个即可

请求示例

{
    "name": "userGroup",
    "description": "",
    "userIdList": [
        "fc709cd0-9089-11eb-b814-01c566421f0e",
        "baf65f80-6846-11eb-a7e5-57c537ca6be9",
        "999b7740-8861-11eb-b91e-f19499d7b5ed",
        "5c3294d0-580d-11eb-973d-236e909a29fd",
        "591147c0-a7c6-11eb-ab50-3d5656bab316"
    ],
    "groupIdList": [
        "4c3294d0-580d-11eb-973d-236e909a29fd",
        "491147c0-a7c6-11eb-ab50-3d5656bab316"
    ],
    "resourceIdList": [],
    "resourceGroupIdList": []
}

返回数据

名称 类型 是否必须 默认值 备注 其他信息
code number 必须 错误码,非0表示失败
data string 必须 角色ID
msg string 必须 描述信息  

返回示例

{
    "code": 0,
    "data": "18041790-5af9-11eb-a393-bbd9cb0893d1",
    "msg": "请求成功"
}

错误信息

错误提示 错误码
组织架构格式错误,路径需以/开头,且不能存在//或以/结尾 7201
参数检查出错 10000001
角色名称(%s)已存在 77200005
本地用户组织架构不存在 77200001
本地用户不存在 77200001
部分用户数据已经删除,请重新选择 10000001
应用不存在 77200001
应用分类不存在 77200001
保存失败,关联的应用不存在或已被删除 77200004
保存失败,关联的应用分类不存在或已被删除 77200004
服务器内部错误 10000000
深信服科技 all right reserved,powered by Gitbook本文档更新于: 2024-05-18 14:38

results matching ""

    No results matching ""